3.4.5 客户端对接 WHMCS

本文介绍智简魔方 DCIM 系统客户端与 WHMCS 的插件安装、服务器及产品配置和常见连接问题，供需要通过 WHMCS 管理服务器的管理员参考。

前言

客户端 WHMCS 插件用于「客户端对接 WHMCS」，实现代理商可使用 WHMCS 插件对接，管理服务器开机、关机等

支持 WHMCS 版本为「whmcs6.x 」「whmcs7.x」

使用该插件需已搭建 Web 客户端，具体操作查看 Web 客户端对接说明

1. 客户端 WHMCS 插件下载和安装方法

功能支持

功能支持界面截图

插件下载和安装

下载： 前往【DCIM 后台】-【产品销售】-【客户管理】，点击右上角的【下载客户端 WHMCS 插件】。

下载：前往【DCIM 后台】-【产品销售】-【客户管理】-【右上相关操作界面截图

安装： 将下载后的插件上传至 WHMCS，并把 clientipmi 文件上传至 WHMCS 根目录下的 modules/servers/。

安装：将下载后的插件【上传至 WHMCS 中】，需将【clien相关操作界面截图

2. WHMCS 中的设置

系统通过 WHMCS 预留的 Server Module 原生方式对接至 WHMCS，使用 WHMCS 原生产品设置和配置选项进行产品的价格定义。

我们使用 WHMCS 默认提供的 Hash 方式，进行一些接口自定义配置，您可根据教程一步一步完成配置。

添加服务器

【前往 WHMCS】-【系统设置】-【服务器设置】-【添加新的服务器】

【前往 WHMCS】-【系统设置】-【服务器设置】-【添加新的服相关操作界面截图

【前往 WHMCS】-【系统设置】-【服务器设置】-【添加新的服相关操作界面截图 必填字段：

NAME（名称）： 任意，可填写 clientipmi
Hostname （主机名）： 填写访问 Web 客户端的域名或 IP 地址
IP（IP 地址）： 填写访问 Web 客户端的域名或 IP 地址

IP（IP 地址）：填写访问 Web 客户端的域名或 IP 地址界面截图

Type（类型）： 选择 clientipmi
Username（用户名）：Web 客户端登录的用户名（账号）
Password（密码）：Web 客户端登录的密码
勾选 SSL： 端口默认为 443，如有变更 Web 客户端访问端口，请填写 Web 客户端端口
Hash（访问散列值） 建议配置如下：查看参数说明

<flowchart>on</flowchart>
<kvm>on</kvm>
<resetbmc>on</resetbmc>
<kvmadmin>on</kvmadmin>
<resetbmcadmin>on</resetbmcadmin>
<reinstall>on</reinstall>
<reinstalladmin>on</reinstalladmin>
<reinstalltimes>99</reinstalltimes>
<adminoutip>on</adminoutip>
<post_emailorid>userid</post_emailorid>
<changehostname>ip</changehostname>
<reboot>on</reboot>
<rebootadmin>on</rebootadmin>
<off>on</off>
<offadmin>on</offadmin>
<on>on</on>
<onadmin>on</onadmin>
<ikvm>on</ikvm>
<ikvmadmin>on</ikvmadmin>
<vnc>on</vnc>
<vncadmin>on</vncadmin>
<idcimadmin>on</idcimadmin>
<rescue>on</rescue>
<rescueadmin>on</rescueadmin>
<crackadmin>on</crackadmin>
<crack>on</crack>
<customport>on</customport>
<custompartition>on</custompartition>

Hash（访问散列值）建议配置如下：查看参数说明界面截图

添加服务器分组

【前往 WHMCS】-【系统设置】-【服务器设置】-【创建新的分组】

【前往 WHMCS】-【系统设置】-【服务器设置】-【创建新的分组】界面截图

分配服务器至分组

分配服务器至分组界面截图

添加产品

前往【系统设置】-【产品/服务】-【产品/服务】-【新增产品】

前往【系统设置】-【产品/服务】-【产品/服务】-【新增产品】界面截图

产品类型： 独服/VPS
产品名称： 服务器产品型号 1
模块设置： 模块名称-clientipmi
服务器组： clientipmi
类型： 服务器租用

类型：服务器租用界面截图

3. WHMCS 前后台管理

产品对接 Web 客户端实现开机、关机和重装管理

完成以上配置后，我们即可实现对接管理，为客户添加产品

完成以上配置后，我们即可实现对接管理，为客户添加产品界面截图

在服务器 ID 处填写该服务器在 Web 客户端的 ID,即可操作功能。

在服务器 ID 处填写该服务器在 Web 客户端的 ID,即可操相关操作界面截图

会员中心管理功能

同时，客户可在会员中心前台进行管理。

关于允许客户使用的功能控制，请参考 4.1 IPMI 插件配置参数说明

关于允许客户使用的功能控制，请参考 4.1 IPMI 插件配置参相关操作界面截图

4. 问题说明

插件配置参数说明

以下为一组完整、可复制的参数示例：

<flowchart>on</flowchart>
<kvm>on</kvm>
<resetbmc>on</resetbmc>
<kvmadmin>on</kvmadmin>
<resetbmcadmin>on</resetbmcadmin>
<reinstall>off</reinstall>
<reinstalladmin>on</reinstalladmin>
<reinstalltimes>3</reinstalltimes>
<adminoutip>on</adminoutip>
<post_emailorid>userid</post_emailorid>
<changehostname>ip</changehostname>
<reboot>on</reboot>
<rebootadmin>off</rebootadmin>
<off>on</off>
<offadmin>on</offadmin>
<on>on</on>
<onadmin>on</onadmin>
<ikvm>on</ikvm>
<ikvmadmin>on</ikvmadmin>
<vnc>on</vnc>
<vncadmin>on</vncadmin>
<idcimadmin>on</idcimadmin>
<rescue>off</rescue>
<rescueadmin>on</rescueadmin>
<crackadmin>on</crackadmin>
<crack>on</crack>
<customport>on</customport>
<custompartition>on</custompartition>

flowchart： 是否开启流量图输出，on 开启，off 关闭。
KVM： 是否开启 KVM 控制按钮输出，on 开启，off 关闭。
resetbmc： 是否输出重置 BMC 按钮，on 开启，off 关闭。
kvmadmin： 管理员界面是否输出 KVM 控制按钮，on 开启，off 关闭。
resetbmcadmin： 管理员界面是否输出重置 BMC 按钮，默认开启。
reinstall / reinstalladmin： 前台和管理后台是否输出重装按钮。
reinstalltimes： 每周允许重装的次数。
adminoutip： 开启后输出后台 IP 控制面板。
post_emailorid： email 传递邮箱，userid 传递 WHMCS 用户 ID。
changehostname： hostname 使用机器名称，IP 使用主 IP，hostnameip 使用“机器名称-主 IP”。
reboot / rebootadmin： 前台和管理后台是否输出重启按钮。
off / offadmin： 前台和管理后台是否输出关机按钮。
on / onadmin： 前台和管理后台是否输出开机按钮。
IKVM / ikvmadmin： 前台和管理后台是否输出 IKVM 按钮。
vnc / vncadmin： 前台和管理后台是否输出 VNC 按钮。
idcimadmin： 管理员界面是否输出快捷跳转服务器管理系统按钮。
rescue / rescueadmin： 前台和管理后台是否输出救援系统按钮。
crack / crackadmin： 前台和管理后台是否输出破解密码按钮。
customport： 前台重装时是否允许自定义端口。
custompartition： 前台重装时是否允许自定义分区。

changehostname 使用“机器名称-主 IP”时的示例：

w20101-10.10.0.1

账号、密码错误

检查 Web 客户端登录信息和 WHMCS 的服务器设置的用户名和密码是否一致

连接端口错误

检查SSL 端口是否填写正确

无法连接

检查 WHMCS 服务器设置中的主机名及 IP是否填写正确

本页目录